【小ネタ】AWS Lambda(Python) から Backlog wiki を更新する

import boto3
import urllib.parse
import urllib.request

ssm = boto3.client('ssm')

def get_api_key(param_name: str) -> str:
    """SSMパラメータストアにあるBacklog APIキー(Secure String)を取得する

    Args:
        param_name (str, optional): APIキーが格納されているパラメータ名.

    Returns:
        str: Backlog API キー
    """
    # https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ssm/client/get_parameter.html
    response = ssm.get_parameter(
        Name=param_name,
        WithDecryption=True
    )
    return response.get('Parameter', {}).get('Value', 'NOVALUE')

def update_wiki_content(space_id: str, wiki_id: str, content: str, api_key: str) -> str:
    """指定した wiki を 指定した content に更新してレスポンスを返す

    Args:
        space_id (str): BacklogのスペースID
        wiki_id (str): 更新対象の wiki_id
        content (str): 更新内容
        api_key (str): Backlog APIキー

    Returns:
        str: レスポンス
    """
    # URLとデータ、ヘッダーを生成する
    url = f"https://{space_id}.backlog.jp/api/v2/wikis/{wiki_id}?apiKey={api_key}"
    data = urllib.parse.urlencode({"content": content}).encode('ascii')
    headers = {"Content-Type": "application/x-www-form-urlencoded"}

    # リクエストを送信して、レスポンスを返す
    # https://docs.python.org/ja/3/howto/urllib2.html#urllib-howto
    # https://developer.nulab.com/ja/docs/backlog/api/2/update-wiki-page/#
    resp = ""
    req = urllib.request.Request(url, data, headers, method='PATCH')
    with urllib.request.urlopen(req) as r:
        resp = r.read().decode()
    return resp

import backlog
import os
import datetime
import logging

logger = logging.getLogger()
logger.setLevel("INFO")

def generate_content() -> str:
    """コンテンツを生成する

    Returns:
        str: コンテンツ
    """
    now = datetime.datetime.now().strftime('%Y-%m-%d(%a) %H:%M:%S')
    content = f"""\
# TEST at {now}

XXX
"""
    return content

def lambda_handler(event, context):
    """コンテンツを生成してBacklog wikiを更新する"""
    # 環境変数からBacklog wiki 更新に必要なパラメータを取得する
    wiki_id = os.getenv('wiki_id', default="[WIKI_ID]")
    space_id = os.getenv('space_id', default='[SPACE_ID]')
    ssm_param_name = os.getenv('ssm_param_name', default='[SSM_PARAM_NAME]')
    logger.info(f"wiki_id={wiki_id}, space_id={
                 space_id}, ssm_param_name={ssm_param_name}")

    # コンテンツを生成する
    content = generate_content()
    logger.info(f"content={repr(content[0:50])}...")

    # Backlog wiki を更新する
    resp = backlog.update_wiki_content(
        space_id=space_id,
        wiki_id=wiki_id,
        content=content,
        api_key=backlog.get_api_key(ssm_param_name)
    )
    logger.info(f"resp={repr(resp[0:50])}...")
    return resp

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:PutLogEvents",
        "logs:CreateLogStream",
        "logs:CreateLogGroup"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:logs:ap-northeast-1:${AccountID}:log-group:/aws/lambda/${FunctionName}:*:*",
        "arn:aws:logs:ap-northeast-1:${AccountID}:log-group:/aws/lambda/${FunctionName}:*"
      ]
    }
  ]
}

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": "ssm:GetParameter",
      "Effect": "Allow",
      "Resource": "arn:aws:ssm:ap-northeast-1:${AccountID}:parameter/${ParameterName}"
    },
    {
      "Action": "kms:Decrypt",
      "Effect": "Allow",
      "Resource": "arn:aws:kms:ap-northeast-1:${AccountID}:key/${KMSKeyID}"
    }
  ]
}

$ aws lambda invoke --function-name update-backlog-wiki /dev/stdout
"{\"id\":1111111111,\"projectId\":1010101010,\"name\":\"Kawahara/sandbox\",\"content\":\"# TEST at 2024-07-10(Wed) 00:17:57\\n\\nXXX\\n\",...以下略
StatusCode: 200